home *** CD-ROM | disk | FTP | other *** search
/ Reverse Code Engineering RCE CD +sandman 2000 / ReverseCodeEngineeringRceCdsandman2000.iso / RCE / Softice Tuts / si-ug-chapter01.rtf next >
Text File  |  2000-05-25  |  5KB  |  117 lines
  1. CHAPTER 1 - Introduction
  2.  
  3.      01.01 Product Description
  4.      01.02 Using This Manual
  5.      01.03 System Requirements
  6.  
  7. 01.01 Product Description
  8.  
  9.      Soft-ICE is a software debugging tool that provides hardware-level
  10.      debugging capabilities to PCDOS and MSDOS debuggers.
  11.  
  12.      Soft-ICE uses 80386 protected mode to run DOS in a virtual machine.
  13.      This gives Soft-ICE complete control of the DOS environment. Soft-ICE
  14.      uses 80386 protected mode features, such as paging, I/O privilege
  15.      level, and break point registers, to add hardware-level break points
  16.      your existing DOS debugger.
  17.  
  18.      Soft-ICE was designed with three goals in mind:
  19.  
  20.         * To utilize the 80386 virtual machine capability to debugging
  21.           features that are impossible or prohibitively slow with
  22.           software-only debuggers (e.g., real time hardware-level break
  23.           points, memory protection, breaking out of hung programs, etc.).
  24.         * To work with existing debuggers. We wanted to provide a tool that
  25.           worked with existing tools. We designed Soft-ICE in such a way
  26.           that you don't have to learn a new debugger to get powerful
  27.           hardware debugging capabilities.
  28.         * To be a user-friendly program with a window that pops up
  29.           instantly and does not get in the way. All of the Soft-ICE
  30.           commands were designed to fit in a small window so that
  31.           information on the screen behind Soft-ICE could still be viewed.
  32.           Dynamic on-line help assists users who only use Soft-ICE
  33.           occasionally.
  34.  
  35.      The Soft-ICE program features:
  36.  
  37.         * real time break points on memory reads/writes, port reads/writes,
  38.           memory ranges, and interrupts
  39.         * back trace history ranges
  40.         * symbolic and source level debugging
  41.         * an environment that works with existing debuggers
  42.         * full EMM 4.0 support
  43.         * backfilling to raise base memory past 640K for monochrome systems
  44.         * a window that can pop up at any time
  45.         * the ability to break out by keystroke even if interrupts are
  46.           disabled
  47.         * debugger code that is isolated by 80386 protected mode. This
  48.           prevents an errant program from modifying or destroying Soft-ICE;
  49.           even if DOS clobbered, Soft-ICE will still work
  50.         * the ability to configure Soft-ICE to use no memory in the lower
  51.           640K if the system has more than 640K
  52.         * user-friendly dynamic help
  53.         * the ability to be used as a stand-alone debugger. This ability is
  54.           useful if you are debugging loadable device drivers, interrupt
  55.           handlers, or boot sequences where traditional debuggers can't go,
  56.           if your debugger suffers from re-entrancy problems
  57.         * a soft boot capability that allows debugging with non-DOS
  58.           operating systems or self-booting programs
  59.         * a simple installation, with no DIP switches to set no I/O ports
  60.           taken up, and no memory address space conflicts
  61.  
  62.      NOTE : Soft-ICE will work with real address mode programs only. It
  63.      will not work with programs that use 80286 or 80386 protected mode
  64.      instructions.
  65.  
  66. 01.02 Using This Manual
  67.  
  68.      The Soft-ICE manual is divided into four main sections:
  69.  
  70.         * Learning Soft-ICE (Section I)
  71.         * Commands (Section II)
  72.         * Support Features (Section lII)
  73.         * Advanced Topics (Section IV)
  74.  
  75.      Soft-ICE can be used for most debugging problems after reading Section
  76.      I, Learning Soft-ICE, and a little experimentation. Soft-ICE's
  77.      user-friendly on-line help can be used to reference command
  78.      descriptions and syntax.
  79.  
  80.      The Learning Soft-ICE section contains installation instructions, a
  81.      description of the user interface, and a tutorial. The tutorial is
  82.      designed to get you up and running quickly.
  83.  
  84.      The Commands section describes all of the Soft-ICE commands. The
  85.      command descriptions are organized by functional group with an
  86.      alphabetic index for reference.
  87.  
  88.      The Support Features section covers advanced loading options, symbolic
  89.      and source level debugging, and EMM 4.0 capability.
  90.  
  91.      The Advanced Topics section covers topics such as using Soft-ICE with
  92.      DOS loadable drivers and using Soft-ICE with non-DOS operating
  93.      systems.
  94.  
  95.      Throughout the manual, especially in the tutorial and the command
  96.      section, examples are given that require you to give data to Soft-ICE.
  97.      When the directions specify that you "press" a key, such as the key,
  98.      you should press the key labelled. When the directions tell you to
  99.      "enter" a phrase, such as WIN, you should type in the specified
  100.      letters, then press the ENTER key.
  101.  
  102. 01.03 System Requirements
  103.  
  104.      Soft-ICE works with the IBM Series II Model 70 and 80, Compaq 80386
  105.      and 80386SX computers, AT compatible and 80386 co-processor cards.
  106.      Soft-ICE will only work with 80386 XT co-processors if they are AT
  107.      compatible.
  108.  
  109.      Soft-ICE works best with extended memory, but works fine with
  110.      conventional memory systems.
  111.  
  112.      Soft-ICE does not use DOS or ROM BIOS for its video output and
  113.      keystroke input. Therefore the video must be compatible with one of
  114.      the following: MDA, Hercules, CGA, EGA, or VGA. Soft-ICE also has
  115.      support for a two- monitor configuration, which can be very helpful
  116.      when debugging video- intensive programs.
  117.